home *** CD-ROM | disk | FTP | other *** search
/ Inter.Net 55-1 / Inter.Net 55-1.iso / CBuilder / Setup / BCB / data.z / mapidbg.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-02-09  |  24.3 KB  |  483 lines
  1. /*
  2.  *  M A P I D B G . H
  3.  *
  4.  *  Debugging support for MAPI service providers.
  5.  *  Support functions are implemented in MAPIDBG.C.
  6.  *
  7.  *  Copyright 1986-1996 Microsoft Corporation. All Rights Reserved.
  8.  */
  9.  
  10. #ifndef __MAPIDBG_H_
  11. #define __MAPIDBG_H_
  12. #pragma option push -b
  13.  
  14.  
  15. #if defined (WIN32) && !defined (_WIN32)
  16. #define _WIN32
  17. #endif
  18.  
  19. /*
  20.  * Debugging Macros -------------------------------------------------------
  21.  *
  22.  *      IFDBG(x)        Results in the expression x if DEBUG is defined, or
  23.  *                      to nothing if DEBUG is not defined
  24.  *
  25.  *      IFNDBG(x)       Results in the expression x if DEBUG is not defined,
  26.  *                      or to nothing if DEBUG is defined
  27.  *
  28.  *      Unreferenced(a) Causes a to be referenced so that the compiler
  29.  *                      doesn't issue warnings about unused local variables
  30.  *                      which exist but are reserved for future use (eg
  31.  *                      ulFlags in many cases)
  32.  */
  33.  
  34. #if defined(DEBUG)
  35. #define IFDBG(x)            x
  36. #define IFNDBG(x)
  37. #else
  38. #define IFDBG(x)
  39. #define IFNDBG(x)           x
  40. #endif
  41.  
  42. #ifdef __cplusplus
  43. #define EXTERN_C_BEGIN      extern "C" {
  44. #define EXTERN_C_END        }
  45. #else
  46. #define EXTERN_C_BEGIN
  47. #define EXTERN_C_END
  48. #endif
  49.  
  50. #define dimensionof(a)      (sizeof(a)/sizeof(*(a)))
  51.  
  52. #define Unreferenced(a)     ((void)(a))
  53.  
  54. typedef long SCODE;
  55. typedef unsigned long ULONG;
  56. typedef unsigned long DWORD;
  57.  
  58. /*
  59.  *   Assert Macros ---------------------------------------------------------
  60.  *  
  61.  *      Assert(a)       Displays a message indicating the file and line number
  62.  *                      of this Assert() if a == 0.  OK'ing an assert traps
  63.  *                      into the debugger.
  64.  *  
  65.  *      AssertSz(a,sz)  Works like an Assert(), but displays the string sz
  66.  *                      along with the file and line number.
  67.  *  
  68.  *      Side asserts    A side assert works like an Assert(), but evaluates
  69.  *                      'a' even when asserts are not enabled.
  70.  *  
  71.  *      NF asserts      A NF (Non-Fatal) assert works like an Assert(), but
  72.  *                      continues instead of trapping into the debugger when
  73.  *                      OK'ed.
  74.  */
  75.  
  76. #if defined(DEBUG) || defined(ASSERTS_ENABLED)
  77. #define IFTRAP(x)           x
  78. #else
  79. #define IFTRAP(x)           0
  80. #endif
  81.  
  82. #define Trap()                                          IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,"Trap"))
  83. #define TrapSz(psz)                                     IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz))
  84. #define TrapSz1(psz,a1)                                 IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1))
  85. #define TrapSz2(psz,a1,a2)                              IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2))
  86. #define TrapSz3(psz,a1,a2,a3)                           IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3))
  87. #define TrapSz4(psz,a1,a2,a3,a4)                        IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4))
  88. #define TrapSz5(psz,a1,a2,a3,a4,a5)                     IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5))
  89. #define TrapSz6(psz,a1,a2,a3,a4,a5,a6)                  IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6))
  90. #define TrapSz7(psz,a1,a2,a3,a4,a5,a6,a7)               IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7))
  91. #define TrapSz8(psz,a1,a2,a3,a4,a5,a6,a7,a8)            IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8))
  92. #define TrapSz9(psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)         IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9))
  93.  
  94. #define Assert(t)                                       IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,"Assertion Failure: " #t),0))
  95. #define AssertSz(t,psz)                                 IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz),0))
  96. #define AssertSz1(t,psz,a1)                             IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1),0))
  97. #define AssertSz2(t,psz,a1,a2)                          IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2),0))
  98. #define AssertSz3(t,psz,a1,a2,a3)                       IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3),0))
  99. #define AssertSz4(t,psz,a1,a2,a3,a4)                    IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4),0))
  100. #define AssertSz5(t,psz,a1,a2,a3,a4,a5)                 IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5),0))
  101. #define AssertSz6(t,psz,a1,a2,a3,a4,a5,a6)              IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6),0))
  102. #define AssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)           IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7),0))
  103. #define AssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)        IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8),0))
  104. #define AssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)     IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9),0))
  105.  
  106. #define SideAssert(t)                                   ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,"Assertion Failure: " #t)),0)
  107. #define SideAssertSz(t,psz)                             ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz)),0)
  108. #define SideAssertSz1(t,psz,a1)                         ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1)),0)
  109. #define SideAssertSz2(t,psz,a1,a2)                      ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2)),0)
  110. #define SideAssertSz3(t,psz,a1,a2,a3)                   ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3)),0)
  111. #define SideAssertSz4(t,psz,a1,a2,a3,a4)                ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4)),0)
  112. #define SideAssertSz5(t,psz,a1,a2,a3,a4,a5)             ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5)),0)
  113. #define SideAssertSz6(t,psz,a1,a2,a3,a4,a5,a6)          ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6)),0)
  114. #define SideAssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)       ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7)),0)
  115. #define SideAssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)    ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8)),0)
  116. #define SideAssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9) ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)),0)
  117.  
  118. #define NFAssert(t)                                     IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,"Assertion Failure: " #t),0))
  119. #define NFAssertSz(t,psz)                               IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz),0))
  120. #define NFAssertSz1(t,psz,a1)                           IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1),0))
  121. #define NFAssertSz2(t,psz,a1,a2)                        IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2),0))
  122. #define NFAssertSz3(t,psz,a1,a2,a3)                     IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3),0))
  123. #define NFAssertSz4(t,psz,a1,a2,a3,a4)                  IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4),0))
  124. #define NFAssertSz5(t,psz,a1,a2,a3,a4,a5)               IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5),0))
  125. #define NFAssertSz6(t,psz,a1,a2,a3,a4,a5,a6)            IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6),0))
  126. #define NFAssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)         IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7),0))
  127. #define NFAssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)      IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8),0))
  128. #define NFAssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)   IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9),0))
  129.  
  130. #define NFSideAssert(t)                                 ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,"Assertion Failure: " #t)),0)
  131. #define NFSideAssertSz(t,psz)                           ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz)),0)
  132. #define NFSideAssertSz1(t,psz,a1)                       ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1)),0)
  133. #define NFSideAssertSz2(t,psz,a1,a2)                    ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2)),0)
  134. #define NFSideAssertSz3(t,psz,a1,a2,a3)                 ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3)),0)
  135. #define NFSideAssertSz4(t,psz,a1,a2,a3,a4)              ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4)),0)
  136. #define NFSideAssertSz5(t,psz,a1,a2,a3,a4,a5)           ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5)),0)
  137. #define NFSideAssertSz6(t,psz,a1,a2,a3,a4,a5,a6)        ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6)),0)
  138. #define NFSideAssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)     ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7)),0)
  139. #define NFSideAssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)  ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8)),0)
  140. #define NFSideAssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)   ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)),0)
  141.  
  142. /*
  143.  *   Trace Macros ------------------------------------------------------------
  144.  *  
  145.  *      DebugTrace          Use for arbitrary formatted output. It
  146.  *                          takes exactly the same arguments as the
  147.  *                          Windows wsprintf() function.
  148.  *      DebugTraceResult    Shorthand for error tracing with an
  149.  *                          HRESULT. Arguments are the name of the
  150.  *                          function (not quoted) and the HRESULT.
  151.  *      DebugTraceSc        Shorthand for error tracing with an
  152.  *                          SCODE. Arguments are the name of the
  153.  *                          function (not quoted) and the SCODE.
  154.  *      DebugTraceArg       Shorthand for invalid parameter
  155.  *                          tracing. Arguments are the name of the
  156.  *                          function (not quoted) and a quoted
  157.  *                          string describing the bad parameter.
  158.  */
  159.  
  160. #if defined(DEBUG) || defined(TRACES_ENABLED)
  161. #define IFTRACE(x)          x
  162. #define DebugTrace          DebugTraceFn
  163. #else
  164. #define IFTRACE(x)          0
  165. #define DebugTrace          1?0:DebugTraceFn
  166. #endif
  167.  
  168. #define DebugTraceResult(f,hr)                          IFTRACE(((hr) ? DebugTraceFn(#f " returns 0x%08lX %s\n", GetScode(hr), SzDecodeScode(GetScode(hr))) : 0))
  169. #define DebugTraceSc(f,sc)                              IFTRACE(((sc) ? DebugTraceFn(#f " returns 0x%08lX %s\n", sc, SzDecodeScode(sc)) : 0))
  170. #define DebugTraceArg(f,s)                              IFTRACE(DebugTraceFn(#f ": bad parameter: " s "\n"))
  171. #define DebugTraceLine()                                IFTRACE(DebugTraceFn("File %s, Line %i  \n",__FILE__,__LINE__))
  172. #define DebugTraceProblems(sz, rgprob)                  IFTRACE(DebugTraceProblemsFn(sz, rgprob))
  173.  
  174. #define TraceSz(psz)                                    IFTRACE(DebugTraceFn("~" psz))
  175. #define TraceSz1(psz,a1)                                IFTRACE(DebugTraceFn("~" psz,a1))
  176. #define TraceSz2(psz,a1,a2)                             IFTRACE(DebugTraceFn("~" psz,a1,a2))
  177. #define TraceSz3(psz,a1,a2,a3)                          IFTRACE(DebugTraceFn("~" psz,a1,a2,a3))
  178. #define TraceSz4(psz,a1,a2,a3,a4)                       IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4))
  179. #define TraceSz5(psz,a1,a2,a3,a4,a5)                    IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5))
  180. #define TraceSz6(psz,a1,a2,a3,a4,a5,a6)                 IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6))
  181. #define TraceSz7(psz,a1,a2,a3,a4,a5,a6,a7)              IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6,a7))
  182. #define TraceSz8(psz,a1,a2,a3,a4,a5,a6,a7,a8)           IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6,a7,a8))
  183. #define TraceSz9(psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)        IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6,a7,a8,a9))
  184.  
  185. /* Debugging Functions ---------------------------------------------------- */
  186.  
  187. EXTERN_C_BEGIN
  188.  
  189. #ifdef WIN16
  190. #define EXPORTDBG   __export
  191. #else
  192. #define EXPORTDBG
  193. #endif
  194.  
  195. int EXPORTDBG __cdecl       DebugTrapFn(int fFatal, char *pszFile, int iLine, char *pszFormat, ...);
  196. int EXPORTDBG __cdecl       DebugTraceFn(char *pszFormat, ...);
  197. void EXPORTDBG __cdecl      DebugTraceProblemsFn(char *sz, void *rgprob);
  198. char * EXPORTDBG __cdecl    SzDecodeScodeFn(SCODE sc);
  199. char * EXPORTDBG __cdecl    SzDecodeUlPropTypeFn(unsigned long ulPropType);
  200. char * EXPORTDBG __cdecl    SzDecodeUlPropTagFn(unsigned long ulPropTag);
  201. unsigned long EXPORTDBG __cdecl UlPropTagFromSzFn(char *psz);
  202. SCODE EXPORTDBG __cdecl     ScodeFromSzFn(char *psz);
  203. void * EXPORTDBG __cdecl    DBGMEM_EncapsulateFn(void * pmalloc, char *pszSubsys, int fCheckOften);
  204. void EXPORTDBG __cdecl      DBGMEM_ShutdownFn(void * pmalloc);
  205. void EXPORTDBG __cdecl      DBGMEM_CheckMemFn(void * pmalloc, int fReportOrphans);
  206. #if defined(_WIN32) && defined(_X86_)
  207. void EXPORTDBG __cdecl      DBGMEM_LeakHook(FARPROC pfn);
  208. void EXPORTDBG __cdecl      GetCallStack(DWORD *, int, int);
  209. #endif
  210. void EXPORTDBG __cdecl      DBGMEM_NoLeakDetectFn(void * pmalloc, void *pv);
  211. void EXPORTDBG __cdecl      DBGMEM_SetFailureAtFn(void * pmalloc, ULONG ulFailureAt);
  212. SCODE EXPORTDBG __cdecl     ScCheckScFn(SCODE, SCODE *, char *, char *, int);
  213. void * EXPORTDBG __cdecl    VMAlloc(ULONG);
  214. void * EXPORTDBG __cdecl    VMAllocEx(ULONG, ULONG);
  215. void * EXPORTDBG __cdecl    VMRealloc(void *, ULONG);
  216. void * EXPORTDBG __cdecl    VMReallocEx(void *, ULONG, ULONG);
  217. ULONG EXPORTDBG __cdecl     VMGetSize(void *);
  218. ULONG EXPORTDBG __cdecl     VMGetSizeEx(void *, ULONG);
  219. void EXPORTDBG __cdecl      VMFree(void *);
  220. void EXPORTDBG __cdecl      VMFreeEx(void *, ULONG);
  221.  
  222. EXTERN_C_END
  223.  
  224. /*
  225.  *  Debugging Macros -------------------------------------------------------
  226.  *  
  227.  *      SzDecodeScode           Returns the string name of an SCODE
  228.  *      SzDecodeUlPropTag       Returns the string name of a property
  229.  *                              tag
  230.  *      UlPropTagFromSz         Given a property tag's name, returns
  231.  *                              its value
  232.  *      ScodeFromSz             Given an SCODE's name, returns its
  233.  *                              value
  234.  *  
  235.  *      DBGMEM_Encapsulate      Given an IMalloc interface, adds heap-
  236.  *                              checking functionality and returns a
  237.  *                              wrapped interface
  238.  *      DBGMEM_Shutdown         Undoes DBGMEM_Encapsulate, and prints
  239.  *                              out information on any allocations made
  240.  *                              since the interface was encapsulated
  241.  *                              that have not yet been released.
  242.  *      DBGMEM_CheckMem         Checks all memory allocated on the heap,
  243.  *                              and optionally reports leaked blocks.
  244.  *      DBGMEM_NoLeakDetect     Prevents a block from appearing on the leak
  245.  *                              report.  Pass NULL for pv to inhibit leak
  246.  *                              reports at all from this heap.
  247.  */
  248.  
  249. #ifdef DEBUG
  250.  
  251. #define SzDecodeScode(_sc)              SzDecodeScodeFn(_sc)
  252. #define SzDecodeUlPropType(_ulPropType) SzDecodeUlPropTypeFn(_ulPropType)
  253. #define SzDecodeUlPropTag(_ulPropTag)   SzDecodeUlPropTagFn(_ulPropTag)
  254. #define UlPropTagFromSz(_sz)            UlPropTagFromSzFn(_sz)
  255. #define ScodeFromSz(_sz)                ScodeFromSzFn(_sz)
  256. #define DBGMEM_Encapsulate(pm, psz, f)  DBGMEM_EncapsulateFn(pm, psz, f)
  257. #define DBGMEM_Shutdown(pm)             DBGMEM_ShutdownFn(pm)
  258. #define DBGMEM_CheckMem(pm, f)          DBGMEM_CheckMemFn(pm, f)
  259. #define DBGMEM_NoLeakDetect(pm, pv)     DBGMEM_NoLeakDetectFn(pm, pv)
  260. #define DBGMEM_SetFailureAt(pm, ul)     DBGMEM_SetFailureAtFn(pm, ul)
  261.  
  262. #else
  263.  
  264. #define SzDecodeScode(_sc)              (0)
  265. #define SzDecodeUlPropType(_ulPropType) (0)
  266. #define SzDecodeUlPropTag(_ulPropTag)   (0)
  267. #define UlPropTagFromSz(_sz)            (0)
  268. #define ScodeFromSz(_sz)                (0)
  269.  
  270. #if defined(__cplusplus) && !defined(CINTERFACE)
  271. #define DBGMEM_Encapsulate(pmalloc, pszSubsys, fCheckOften) \
  272.     ((pmalloc)->AddRef(), (pmalloc))
  273. #define DBGMEM_Shutdown(pmalloc) \
  274.     ((pmalloc)->Release())
  275. #else
  276. #define DBGMEM_Encapsulate(pmalloc, pszSubsys, fCheckOften) \
  277.     ((pmalloc)->lpVtbl->AddRef(pmalloc), (pmalloc))
  278. #define DBGMEM_Shutdown(pmalloc) \
  279.     ((pmalloc)->lpVtbl->Release(pmalloc))
  280. #endif
  281. #define DBGMEM_CheckMem(pm, f)
  282. #define DBGMEM_NoLeakDetect(pm, pv)
  283. #define DBGMEM_SetFailureAt(pm, ul)
  284.  
  285. #endif
  286.  
  287. /*
  288.  *  SCODE maps -------------------------------------------------------------
  289.  *  
  290.  *      ScCheckSc       Given an SCODE and method name, verifies
  291.  *                      that the SCODE can legally be returned from
  292.  *                      thet method. Prints out a debug string if
  293.  *                      it cannot.
  294.  *      HrCheckHr       As ScCheckSc, for functions that return
  295.  *                      HRESULT.
  296.  */
  297.  
  298. #if defined(DEBUG) && !defined(DOS)
  299. #define ScCheckSc(sc,fn)                ScCheckScFn(sc,fn##_Scodes,#fn,__FILE__, __LINE__)
  300. #define HrCheckHr(hr,fn)                HrCheckSc(GetScode(hr),fn)
  301. #else
  302. #define ScCheckSc(sc,fn)                (sc)
  303. #define HrCheckHr(hr,fn)                (hr)
  304. #endif
  305.  
  306. #define HrCheckSc(sc,fn)                ResultFromScode(ScCheckSc(sc,fn))
  307.  
  308. #if defined(DEBUG) && !defined(DOS)
  309. extern SCODE Common_Scodes[];
  310. extern SCODE MAPILogon_Scodes[];
  311. extern SCODE MAPIAllocateBuffer_Scodes[];
  312. extern SCODE MAPIAllocateMore_Scodes[];
  313. extern SCODE MAPIFreeBuffer_Scodes[];
  314.  
  315. extern SCODE IUnknown_QueryInterface_Scodes[];
  316. extern SCODE IUnknown_AddRef_Scodes[];
  317. extern SCODE IUnknown_Release_Scodes[];
  318. extern SCODE IUnknown_GetLastError_Scodes[];
  319.  
  320. extern SCODE IMAPIProp_CopyTo_Scodes[];
  321. extern SCODE IMAPIProp_CopyProps_Scodes[];
  322. extern SCODE IMAPIProp_DeleteProps_Scodes[];
  323. extern SCODE IMAPIProp_GetIDsFromNames_Scodes[];
  324. extern SCODE IMAPIProp_GetLastError_Scodes[];
  325. extern SCODE IMAPIProp_GetNamesFromIDs_Scodes[];
  326. extern SCODE IMAPIProp_GetPropList_Scodes[];
  327. extern SCODE IMAPIProp_GetProps_Scodes[];
  328. extern SCODE IMAPIProp_OpenProperty_Scodes[];
  329. extern SCODE IMAPIProp_SetProps_Scodes[];
  330. extern SCODE IMAPIProp_SaveChanges_Scodes[];
  331.  
  332. extern SCODE IStream_Read_Scodes[];
  333. extern SCODE IStream_Write_Scodes[];
  334. extern SCODE IStream_Seek_Scodes[];
  335. extern SCODE IStream_SetSize_Scodes[];
  336. extern SCODE IStream_Tell_Scodes[];
  337. extern SCODE IStream_LockRegion_Scodes[];
  338. extern SCODE IStream_UnlockRegion_Scodes[];
  339. extern SCODE IStream_Clone_Scodes[];
  340. extern SCODE IStream_CopyTo_Scodes[];
  341. extern SCODE IStream_Revert_Scodes[];
  342. extern SCODE IStream_Stat_Scodes[];
  343. extern SCODE IStream_Commit_Scodes[];
  344.  
  345. extern SCODE IMAPITable_GetLastError_Scodes[];
  346. extern SCODE IMAPITable_Advise_Scodes[];
  347. extern SCODE IMAPITable_Unadvise_Scodes[];
  348. extern SCODE IMAPITable_GetStatus_Scodes[];
  349. extern SCODE IMAPITable_SetColumns_Scodes[];
  350. extern SCODE IMAPITable_QueryColumns_Scodes[];
  351. extern SCODE IMAPITable_GetRowCount_Scodes[];
  352. extern SCODE IMAPITable_SeekRow_Scodes[];
  353. extern SCODE IMAPITable_SeekRowApprox_Scodes[];
  354. extern SCODE IMAPITable_QueryPosition_Scodes[];
  355. extern SCODE IMAPITable_FindRow_Scodes[];
  356. extern SCODE IMAPITable_Restrict_Scodes[];
  357. extern SCODE IMAPITable_CreateBookmark_Scodes[];
  358. extern SCODE IMAPITable_FreeBookmark_Scodes[];
  359. extern SCODE IMAPITable_SortTable_Scodes[];
  360. extern SCODE IMAPITable_QuerySortOrder_Scodes[];
  361. extern SCODE IMAPITable_QueryRows_Scodes[];
  362. extern SCODE IMAPITable_Abort_Scodes[];
  363. extern SCODE IMAPITable_ExpandRow_Scodes[];
  364. extern SCODE IMAPITable_CollapseRow_Scodes[];
  365. extern SCODE IMAPITable_WaitForCompletion_Scodes[];
  366. extern SCODE IMAPITable_GetCollapseState_Scodes[];
  367. extern SCODE IMAPITable_SetCollapseState_Scodes[];
  368.  
  369. extern SCODE IMAPISession_LogOff_Scodes[];
  370. extern SCODE IMAPISession_Release_Scodes[];
  371. extern SCODE IMAPISession_GetLastError_Scodes[];
  372. extern SCODE IMAPISession_GetMsgStoresTable_Scodes[];
  373. extern SCODE IMAPISession_GetStatusTable_Scodes[];
  374. extern SCODE IMAPISession_OpenMsgStore_Scodes[];
  375. extern SCODE IMAPISession_OpenAddressBook_Scodes[];
  376. extern SCODE IMAPISession_OpenEntry_Scodes[];
  377. extern SCODE IMAPISession_OpenProfileSection_Scodes[];
  378. extern SCODE IMAPISession_Advise_Scodes[];
  379. extern SCODE IMAPISession_Unadvise_Scodes[];
  380. extern SCODE IMAPISession_CompareEntryIDs_Scodes[];
  381. extern SCODE IMAPISession_MessageOptions_Scodes[];
  382. extern SCODE IMAPISession_QueryDefaultMessageOpt_Scodes[];
  383. extern SCODE IMAPISession_EnumAdrTypes_Scodes[];
  384. extern SCODE IMAPISession_QueryIdentity_Scodes[];
  385. extern SCODE IMAPISession_OpenProfileSection_Scodes[];
  386. extern SCODE IMAPISession_GetStatusTable_Scodes[];
  387.  
  388. extern SCODE IMsgStore_Advise_Scodes[] ;
  389. extern SCODE IMsgStore_Unadvise_Scodes[] ;
  390. extern SCODE IMsgStore_CompareEntryIDs_Scodes[] ;
  391. extern SCODE IMsgStore_OpenEntry_Scodes[] ;
  392. extern SCODE IMsgStore_SetReceiveFolder_Scodes[];
  393. extern SCODE IMsgStore_GetReceiveFolder_Scodes[];
  394. extern SCODE IMsgStore_GetReceiveFolderTable_Scodes[];
  395. extern SCODE IMsgStore_StoreLogoff_Scodes[];
  396. extern SCODE IMsgStore_AbortSubmit_Scodes[];
  397. extern SCODE IMsgStore_GetOutgoingQueue_Scodes[] ;
  398. extern SCODE IMsgStore_SetLockState_Scodes[] ;
  399. extern SCODE IMsgStore_FinishedMsg_Scodes[] ;
  400. extern SCODE IMsgStore_NotifyNewMail_Scodes[];
  401.  
  402. extern SCODE IMAPIFolder_GetContentsTable_Scodes[];
  403. extern SCODE IMAPIFolder_GetHierarchyTable_Scodes[];
  404. extern SCODE IMAPIFolder_SaveContentsSort_Scodes[];
  405. extern SCODE IMAPIFolder_OpenEntry_Scodes[];
  406. extern SCODE IMAPIFolder_CreateMessage_Scodes[];
  407. extern SCODE IMAPIFolder_CopyMessages_Scodes[];
  408. extern SCODE IMAPIFolder_DeleteMessages_Scodes[];
  409. extern SCODE IMAPIFolder_CreateFolder_Scodes[];
  410. extern SCODE IMAPIFolder_CopyFolder_Scodes[];
  411. extern SCODE IMAPIFolder_DeleteFolder_Scodes[];
  412. extern SCODE IMAPIFolder_SetSearchCriteria_Scodes[];
  413. extern SCODE IMAPIFolder_GetSearchCriteria_Scodes[];
  414. extern SCODE IMAPIFolder_SetReadFlags_Scodes[];
  415. extern SCODE IMAPIFolder_GetMessageStatus_Scodes[];
  416. extern SCODE IMAPIFolder_SetMessageStatus_Scodes[];
  417. extern SCODE IMAPIFolder_EmptyFolder_Scodes[];
  418.  
  419. extern SCODE IMessage_SaveChanges_Scodes[];
  420. extern SCODE IMessage_GetAttachmentTable_Scodes[];
  421. extern SCODE IMessage_OpenAttach_Scodes[];
  422. extern SCODE IMessage_CreateAttach_Scodes[];
  423. extern SCODE IMessage_DeleteAttach_Scodes[];
  424. extern SCODE IMessage_GetRecipientTable_Scodes[];
  425. extern SCODE IMessage_ModifyRecipients_Scodes[];
  426. extern SCODE IMessage_SubmitMessage_Scodes[];
  427. extern SCODE IMessage_SetReadFlag_Scodes[];
  428.  
  429. extern SCODE IAttach_SaveChanges_Scodes[];
  430.  
  431. extern SCODE IAddrBook_OpenEntry_Scodes[];
  432. extern SCODE IAddrBook_CompareEntryIDs_Scodes[];
  433. extern SCODE IAddrBook_CreateOneOff_Scodes[];
  434. extern SCODE IAddrBook_ResolveName_Scodes[];
  435. extern SCODE IAddrBook_Address_Scodes[];
  436. extern SCODE IAddrBook_Details_Scodes[];
  437. extern SCODE IAddrBook_RecipOptions_Scodes[];
  438. extern SCODE IAddrBook_QueryDefaultRecipOpt_Scodes[];
  439. extern SCODE IAddrBook_Address_Scodes[];
  440. extern SCODE IAddrBook_ButtonPress_Scodes[];
  441.  
  442. extern SCODE IABContainer_GetContentsTable_Scodes[];
  443. extern SCODE IABContainer_GetHierarchyTable_Scodes[];
  444.  
  445. extern SCODE INotifObj_ChangeEvMask_Scodes[];
  446.  
  447. extern SCODE IMAPIStatus_ChangePassword_Scodes[];
  448. extern SCODE IMAPIStatus_FlushQueues_Scodes[];
  449. extern SCODE IMAPIStatus_SettingsDialog_Scodes[];
  450. extern SCODE IMAPIStatus_ValidateState_Scodes[];
  451.  
  452. extern SCODE IMSProvider_Logon_Scodes[];
  453. extern SCODE IMSProvider_Deinit_Scodes[];
  454. extern SCODE IMSProvider_Init_Scodes[];
  455. extern SCODE IMSProvider_SpoolerLogon_Scodes[];
  456. extern SCODE IMSProvider_Shutdown_Scodes[];
  457.  
  458. extern SCODE SMAPI_MAPILogon_Scodes[];
  459. extern SCODE SMAPI_MAPILogoff_Scodes[];
  460. extern SCODE SMAPI_MAPIFreeBuffer_Scodes[];
  461. extern SCODE SMAPI_MAPISendMail_Scodes[];
  462. extern SCODE SMAPI_MAPISendDocuments_Scodes[];
  463. extern SCODE SMAPI_MAPIFindNext_Scodes[];
  464. extern SCODE SMAPI_MAPIReadMail_Scodes[];
  465. extern SCODE SMAPI_MAPISaveMail_Scodes[];
  466. extern SCODE SMAPI_MAPIDeleteMail_Scodes[];
  467. extern SCODE SMAPI_MAPIAddress_Scodes[];
  468. extern SCODE SMAPI_MAPIResolveName_Scodes[];
  469. extern SCODE SMAPI_MAPIDetails_Scodes[];
  470.  
  471. extern SCODE IMSLogon_OpenEntry_Scodes[];
  472. extern SCODE IMSLogon_OpenStatusEntry_Scodes[];
  473. extern SCODE IMSLogon_CompareEntryIDs_Scodes[];
  474. extern SCODE IMSLogon_Advise_Scodes[];
  475. extern SCODE IMSLogon_Unadvise_Scodes[];
  476. extern SCODE IMSLogon_Logoff_Scodes[];
  477. #endif
  478.  
  479. /* ------------------------------------------------------------------------ */
  480.  
  481. #pragma option pop
  482. #endif
  483.